Skip to content

Update from code changes: document static export URLs - #6875

Merged
ethanpalm merged 6 commits into
mainfrom
docs/static-export-html-links
Aug 10, 2026
Merged

Update from code changes: document static export URLs#6875
ethanpalm merged 6 commits into
mainfrom
docs/static-export-html-links

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Document the .html URLs emitted by static export bundles so they work on hosts without extensionless rewrites.

Changes

  • Explain root and page URL examples.
  • Describe CloudFront navigation and plain file hosting.
  • Note automatic configuration and extensionless canonical and sitemap URLs.
  • Document .html destinations for built-in internal navigation, including version and language switchers, search results, cards, assistant citations, and API playground links.

Context

This documents the static export URL changes in mintlify/mint#9840 and the follow-up imperative navigation fix in mintlify/mint#9842.


Note

Low Risk
Documentation-only changes to static export overview pages; no application or API code.

Overview
Documents how static export bundles expose pages as explicit .html URLs (e.g. /guides/getting-started.html, /index.html) so self-hosters know what to expect when uploading to S3 or plain static hosting without extensionless rewrites.

Adds a Page URLs in static bundles section (with anchor page-urls-in-static-bundles in localized pages) to the English, Spanish, French, and Chinese api/static-export/overview pages. The new copy explains that the Static Export API turns this on automatically, contrasts CloudFront (client nav/prefetch preserved) with file-only hosts (full-page .html links), and notes that canonical/sitemap and optional client nav URLs can stay extensionless—with a caveat that file-only hosts may need rewrites.

The Chinese overview also extends the frontmatter description with S3/CDN/static hosting context.

The localized overviews now also explain that built-in internal navigation uses .html destinations and preserves query strings.

Reviewed by Cursor Bugbot for commit ac1abc1. Bugbot is set up for automated code reviews on this repo. Configure here.

Update history

  • 2026-08-05: Added coverage for the imperative navigation fixes in mintlify/mint#9842, including switchers, search, assistant, cards, and API playground links.

Note

Low Risk
Documentation-only updates to static export overview MDX; no application or API code changes.

Overview
Adds a Page URLs in static bundles section to the static export overview in English, Spanish, French, and Chinese, describing how exported pages use explicit .html paths (e.g. /guides/getting-started.html, /index.html in localized copy) so bundles align with files on S3 or plain static hosts.

The new text states the Static Export API enables this without doc config changes, contrasts CloudFront (client navigation/prefetch) with file-only hosting (full-page .html links), and notes that canonical and sitemap URLs stay extensionless—with a warning that non-CloudFront hosts may need rewrites. Localized pages also document built-in internal navigation (switchers, search, cards, assistant, API playground) using .html targets while preserving query strings. The Chinese overview extends frontmatter description with S3/CDN hosting context.

Reviewed by Cursor Bugbot for commit 018a278. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🔴 Failed Aug 10, 2026, 9:37 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 5, 2026, 7:10 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Updated wording, translation phrasing, heading consistency, and Chinese SEO metadata

Source PRs

  • mintlify/mint#9842 — fix(client): apply html-links extension to router.push nav targets

Comment thread api/static-export/overview.mdx Outdated
@mintlify-development

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟡 Building Aug 10, 2026, 9:22 PM

@mintlify-development

mintlify-development Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
prosignuptest 🟢 Ready View Preview Aug 10, 2026, 9:26 PM

@mintlify-development

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟡 Building Aug 10, 2026, 9:22 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify-development

mintlify-development Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
testing 🔴 Failed Aug 10, 2026, 9:31 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment thread api/static-export/overview.mdx Outdated
@ethanpalm
ethanpalm merged commit 17c95e4 into main Aug 10, 2026
6 checks passed
@ethanpalm
ethanpalm deleted the docs/static-export-html-links branch August 10, 2026 21:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants